OLA 文档中心

主题

2026-07-18

测试文件保护驱动通信 - ProtectFileTestDriver ​

函数简介 ​

测试文件保护驱动通信是否正常。(高级版功能,普通版无法使用)

接口名称 ​

ProtectFileTestDriver

DLL调用 ​

c
int32_t ProtectFileTestDriver(int64_t instance);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int ret = ola.ProtectFileTestDriver();
csharp
using OLAPlug;

var ola = new OLAPlugServer();
int ret = ola.ProtectFileTestDriver();
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
ret = ola.ProtectFileTestDriver()
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
int ret = ola.ProtectFileTestDriver();
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
ret := ola.ProtectFileTestDriver()
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let ret = ola.protect_file_test_driver();
cpp
var ola = com("OlaPlug.OlaSoft")
var ret = ola.ProtectFileTestDriver()
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
ret = ola.ProtectFileTestDriver()
text
.局部变量 ola, OLAPlug
ola.创建 ()
ret ＝ ola.ProtectFileTestDriver()
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var ret = ola.ProtectFileTestDriver();
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
整数 ret = ola.ProtectFileTestDriver()
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int32_t ret = ola.ProtectFileTestDriver();

原生 DLL 调用 ​

cpp
ProtectFileTestDriver(instance);
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int ProtectFileTestDriver(long ola);

ProtectFileTestDriver(instance);
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
ola.ProtectFileTestDriver(instance)

返回值 ​

成功返回 1；失败时返回值即为错误码（与 DriverTest / EnableVtDriver 一致），可配合 GetLastError() / GetLastErrorString() 查询。

完整错误码表见 驱动错误码说明 - DriverErrorCodes。本接口失败时常见 ProtectFile 段错误（0xDFDFD00x）。

十进制（int32）十六进制说明
1—成功，文件保护驱动通讯正常。
0—权限不足，或与驱动通讯失败（未拿到 Status）。
其他负数见码表驱动 Status，常见 -538980351（0xDFDFD001）、-538980350（0xDFDFD002）等 ProtectFile 段。

TIP

接口返回值即为十进制错误码，可在 驱动错误码说明 中 Ctrl+F 搜索该数字快速定位。

注意事项 ​

项目说明
驱动用于验证文件保护驱动是否正常工作；建议在 ProtectFileEnableDriver 之后调用。
错误排查失败时优先查看返回值与 驱动错误码说明 中的 ProtectFile 段。